home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d12 / stpdos12.arc / STEPDOS.DOC < prev   
Text File  |  1987-12-05  |  7KB  |  136 lines

  1.  
  2.                               STEPDOS
  3.  
  4.                                 by
  5.  
  6.                             Mike Parker
  7.                        2374 Meadowpark Court
  8.                      Maryland Heights, MO 63043
  9.  
  10.                            CIS 70270,161
  11.  
  12.                              11/21/87
  13.                             Version 1.2
  14.  
  15.        ============================================================
  16.                          Program Description
  17.        ============================================================
  18.  
  19. STEPDOS is a program written in assembly language that intercepts DOS
  20. interrupt 21H then executes the target program specified on the command
  21. line as a subprocess. Each time the target program does an 'INT 21H' call,
  22. STEPDOS takes over. A 'pop-up window' is displayed with the values of
  23. all registers and a description of what the DOS call is about to do.
  24.  
  25. STEPDOS detects whether a CGA or Monochrome adapter is installed and will
  26. determine which video page is currently active each time it puts up the
  27. information window.
  28.  
  29.        ============================================================
  30.                             Program Execution
  31.        ============================================================
  32.  
  33. There is a program included in the STEPDOS.ARC file called DEMO.COM
  34. that will give a short demonstration of STEPDOS's capabilities.
  35.  
  36. DEMO.COM does three functions.
  37.   1) Outputs a string using calls to DOS function code 02h (Display Character).
  38.   2) Checks keyboard input status.
  39.   3) Terminates itself.
  40.  
  41.  
  42. For this demonstration first clear the screen by typing CLS <return>.
  43. Make sure DEMO.COM is in your current directory and type:
  44.     STEPDOS DEMO <return>
  45.  
  46.  
  47. A window will pop up showing something like:
  48.  
  49.    +-----------------------------------------------------------------------+
  50.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  51.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  52.    | 02xx xxxx xxxx xx54 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  53.    |                                                                       |
  54.    |                                                                       |
  55.    | Output Character  Hex 54  ASCII T                                     |
  56.    |                                                                       |
  57.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  58.    +-----------------------------------------------------------------------+
  59.  
  60. The xxxx's under the register names above just mean that what you actually
  61. see could be anything, only AH and DL are important right here.
  62.  
  63. Press any key except 'S', 'R', the ARROW keys or 'ESCAPE' to execute the
  64. DOS function.
  65.  
  66. The character 'T' will be displayed at the current cursor position and the
  67. STEPDOS window will come up again with:
  68.  
  69.  
  70.    +-----------------------------------------------------------------------+
  71.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  72.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  73.    | 02xx xxxx xxxx xx68 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  74.    |                                                                       |
  75.    |                                                                       |
  76.    | Output Character  Hex 68  ASCII h                                     |
  77.    |                                                                       |
  78.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  79.    +-----------------------------------------------------------------------+
  80.  
  81. Press a key and the 'h' character will appear after the 'T'.
  82. To keep you from having to press a key to display each character of a
  83. potentially long text string use the 'Skip Current Func' option.
  84. This tells STEPDOS to run nonstop as long as the current function (in this
  85. case 02h) is being repeated by the target program.
  86. When a function code other than 02h is executed, STEPDOS will resume display.
  87.  
  88. Now press 'S' to finish displaying the demo string. The following will appear:
  89.  
  90.    +-----------------------------------------------------------------------+
  91.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  92.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  93.    | 0Bxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  94.    |                                                                       |
  95.    |                                                                       |
  96.    | Check Standard Input Status                                           |
  97.    |                                                                       |
  98.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  99.    +-----------------------------------------------------------------------+
  100.  
  101.  
  102. To see how the 'Return Code' option works press the 'R' key and you
  103. will see:
  104.  
  105.    +-----------------------------------------------------------------------+
  106.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  107.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  108.    | 0B00 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  109.    |                                                                       |
  110.    |                                                                       |
  111.    | Return Code = 0B00H    Carry Flag = 0   Zero Flag = 1                 |
  112.    |                                                                       |
  113.    |                     Press Any Key To Continue                         |
  114.    +-----------------------------------------------------------------------+
  115.  
  116. This is the result immediately after the INT 21h code is executed.
  117.  
  118. Press any key to see:
  119.  
  120.    +-----------------------------------------------------------------------+
  121.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  122.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  123.    | 4C00 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  124.    |                                                                       |
  125.    |                                                                       |
  126.    | Terminate Process With Return Code 00H                                |
  127.    |                                                                       |
  128.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  129.    +-----------------------------------------------------------------------+
  130.  
  131. If the window is covering up a part of the screen you would like to see,
  132. press any of the cursor positioning keys on the numeric keypad and the
  133. window will move.
  134.  
  135. Press a key and STEPDOS will end, returning you to the DOS prompt.
  136.